Inside Macintosh: QuickDraw GX Printing /

Chapter 4 - Advanced Printing Features / Advanced Printing Features Reference

Functions / Manipulating Printer Objects

GXForEachPrinterViewDeviceDo

You can use the GXForEachPrinterViewDeviceDo function to execute an application-defined function on each view device associated with a particular printer object.

void GXForEachPrinterViewDeviceDo (gxPrinter aPrinter,
                                 gxViewDeviceProc aViewDeviceProc,
                                 void *refCon);

aPrinter

A reference to the printer object whose view devices you want to manipulate.

aViewDeviceProc

The function you want to execute for each view device.

refCon

A pointer to the reference constant that is passed to the application-defined function.

DESCRIPTION

You can use the GXForEachPrinterViewDeviceDo function to perform the actions specified in an application-defined function, aViewDeviceProc, on all the view devices associated with a particular printer object.

The GXForEachPrinterViewDeviceDo function calls your application-defined function and terminates when the application-defined function returns gxStopLooping or when GXForEachPrinterViewDeviceDo has been called for each view device.

RESULT CODES

gxSegmentLoadFailedErr

A required code segment could not be found, or there was not enough memory to load it.

SEE ALSO

For information about declaring the application-defined function, see "Message Override Function for the Printing Status Dialog Box" on page 4-90.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help